Skip to content

docs(docsite): correct two stale backdropGlow comments left by #5415 - #5467

Merged
imdreamrunner merged 2 commits into
mainfrom
codex/hero-glow-comment-accuracy
Aug 26, 2026
Merged

docs(docsite): correct two stale backdropGlow comments left by #5415#5467
imdreamrunner merged 2 commits into
mainfrom
codex/hero-glow-comment-accuracy

Conversation

@imdreamrunner

@imdreamrunner imdreamrunner commented Aug 25, 2026

Copy link
Copy Markdown
Contributor

Follow-up to #5415 (issue #5392). Comments only — no behavior change, no CSS change.

#5415 made the hero's aurora glow responsive (absolute below 1024px, fixed at and above it). Two comments on that same style object were left describing the old unconditional behavior. Both are corrected here.

1. The causal chain was inverted

The comment added in #5415 says:

a fixed glow below 1024px reached past the footer into the bottom-overscroll gap, which blocked pull-to-refresh from ever registering a release

The glow never blocked pull-to-refresh. overscroll-behavior-y: none in globals.css did — the glow is the reason that rule was written. The direction matters: the rule suppressed the whole page's overscroll to hide one bleeding layer, and bounding the layer is what let the rule retreat to desktop widths. As written, the comment sends the next person to the wrong file.

- for the whole page — a fixed glow below 1024px reached past the
- footer into the bottom-overscroll gap, which blocked pull-to-refresh
- from ever registering a release (#5392).
+ for the whole page — a fixed glow below 1024px reached past the footer
+ into the bottom-overscroll gap. That exposure is what the app-global
+ `overscroll-behavior-y: none` in globals.css was suppressing, at the
+ cost of pull-to-refresh on every route on mobile; bounding the glow
+ here is what lets that rule scope to desktop widths (#5392).

2. The header comment still claimed the glow is unconditionally fixed

Four lines above, the comment introducing backdropGlow opened with "Blurred aurora glow — fixed, …". Since #5415 that is only true at ≥1024px.

Both sibling layers state their split — HeroFloatingCards's stage says "Hidden <1024px", page.tsx's heroContent says "Desktop: fixed … Narrow: in flow" — so this was the one layer comment hiding its responsive behavior, and the first thing a reader hits.

- // Blurred aurora glow — fixed, in the same 1200px box as the cards so blobs
- // and cards stay aligned. Capped to 100vw to avoid horizontal scroll. Blob
- // centers sit under the card clusters; colors come from --aurora-* per slide.
+ // Blurred aurora glow — in the same 1200px box as the cards so blobs and
+ // cards stay aligned; pinned at >=1024px and scrolling away with the hero
+ // below that (see `position`). Capped to 100vw to avoid horizontal scroll.
+ // Blob centers sit under the card clusters; colors come from --aurora-* per
+ // slide.

Risk

None. Ten comment lines in one file; no code, no styles.

Testing

prettier --check and eslint --no-cache clean on the changed file. check:changesets passes — no changeset needed (docsite app code, not a published package, and nothing consumer-visible). CI was green on the first commit and covers the second.

The comment said a fixed glow below 1024px 'blocked pull-to-refresh from
ever registering a release'. It never did — `overscroll-behavior-y: none`
in globals.css did. The glow is the *reason that rule was written*: it was
the layer bleeding into the bottom-overscroll gap, and bounding it is what
lets the rule scope to desktop widths.

Comment only, no behavior change. Follow-up to #5415 (issue #5392).
@vercel

vercel Bot commented Aug 25, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
astryx Ready Ready Preview Aug 26, 2026 2:42am

Request Review

@meta-cla meta-cla Bot added the CLA Signed This label is managed by the Meta Open Source bot. label Aug 25, 2026
@github-actions github-actions Bot added the needs:design-review Affects visuals — Design should review label Aug 25, 2026
…eader comment

The comment directly above backdropGlow still described the layer as
'fixed' full stop. Since #5415 that is only true at >=1024px; below that
it is absolute inside heroScope. Same defect class as the comment this
branch already corrects, four lines away.

Both siblings state the split — HeroFloatingCards' stage says 'Hidden
<1024px', page.tsx's heroContent says 'Desktop: fixed ... Narrow: in
flow' — so this was the one layer comment that hid its responsive
behavior.

Comment only, no behavior change.
@imdreamrunner imdreamrunner changed the title docs(docsite): correct the backdropGlow comment's causal chain docs(docsite): correct two stale backdropGlow comments left by #5415 Aug 26, 2026
@imdreamrunner
imdreamrunner marked this pull request as ready for review August 26, 2026 02:49
@imdreamrunner
imdreamrunner merged commit cf77229 into main Aug 26, 2026
23 checks passed
@github-actions
github-actions Bot deleted the codex/hero-glow-comment-accuracy branch August 26, 2026 06:13
AKnassa added a commit to AKnassa/astryx that referenced this pull request Aug 27, 2026
Contain the desktop-pinned hero layers so the app-global
`overscroll-behavior-y: none` can be deleted outright instead of gated
to desktop widths: macOS trackpads get their native rubber-band back.

A `fixed` layer is not part of the document, so when the document
rubber-bands past its own edge the layer sits in the exposed gap. A
`sticky` layer lifts with the document and cannot paint past its
containing block. Each pinned layer (aurora backdrop, overlap cards,
hero text) now rides its own `absolute; inset: 0` rail, a direct child
of heroScope spanning hero band + showcase and placed ahead of the
showcase overlay, as a `position: sticky` box at >=1024px. Centering
moves from `left: 50%` + `translateX(-50%)` to auto margins inside the
full-width rail, and the 1200px box is capped to the rail's width rather
than 100vw: with a classic scrollbar 100vw is wider than the rail, which
zeroes the auto margins and shoves the box left. A rail inside the 760px
band alone would release the layer after ~48px, which is why the rails
span the showcase too.

HeroReelProvider is context-only now; its hover/focus/touch surface is
the new HeroReelSwipeArea, which page.tsx uses as the hero text's rail
so the band still pauses the reel and the mobile collage still swipes.

Also records on LayoutContent why `overflow: clip` must stay `clip`:
`hidden` or `auto` there would silently un-pin the landing page. A
source-invariant test (the docsite suite is node-only) guards the rule's
absence, the three layers never going back to `fixed`, the rails' order
and containment, and the AppShell/LayoutContent links that keep the main
area a non-scroll container.

Verified against untouched main with Playwright + pixelmatch at six
viewports x ten scroll offsets: 0 px at the default threshold, identical
layer geometry, `overscroll-behavior-y: auto` everywhere, no fixed
element reaching the viewport bottom (was 2-3), 11/11 hover/focus/swipe
checks passing on both trees, resize-while-scrolled and theme-swap
mid-scroll 0 px. Safari and a real rubber-band are not verified here.

Step 2 of facebook#5392. Fixes facebook#5470. Supersedes the zero-height-pin approach
in facebook#5431 and folds in the backdropGlow comment correction from facebook#5467.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed This label is managed by the Meta Open Source bot. needs:design-review Affects visuals — Design should review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant